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= {5} x} 
Address} Value | Type | 


#DEMOMOD#val int 0x027D 637 unsigned int 
2| W2 #DEMOMOD#main#i_array {0x7B,0x7B,0x7B 0x7B0x7B,0x7B 0x7B,0x7B,0x7B 0: unsigned int [10] 


3 #DEMOMOD#main# message |{"Hitex HiTOP98 for SAB C166 Tools for C166m\0\xE 


4 a 
| $ {Exam1} Examine - #DEMOMOD #mainttmessage 


àt address: DPP1:0x114E Size: 58 Bytes 
| struct c_: 


© {Watch} Watch 





c_array "Hitex HiTOP98 for SAB C166 Tools for C166m\0\xEOH2 ‘\a\x80\xD8" 
text _ptr DPP1:OxO10E [texti] 


be At ped AL s {Exam2} Examine - #DEMOMOD #mainttmessa... Eel Ed 


At address: DPP1:0x1184 Size: 4 Bytes 
0x01 1 "\1' o000000iy 
0x0001 1 


page {0x1,0x2001} 





struct simple page state 


number 
struct simple 


Figure 1. Watching and examin- 
ing variables. 


A strategic partner of chip manufacturer 
Siemens and a leading supplier of develop- 
ment tools for the 16-bit 80C 166 microcon- 
troller family, Germany-based Hitex System 

Development have adapted their target code 
debugger telemon 166 to the requirements of 
the Elektor Electronics 80C166 evaluation sys- 
tem published in the March and April 1999 
magazines. This modified version of tele- 

mon 166 is now available on diskette. 


applications (engine management, 
power steering, etc.), but also in hard 
disk control systems. The architectural 
similarities with the ageing and widely 
used 8-bit 8051/C500 controller family 
often cause developers to upgrade to 
the C166 once the limits of 8-bit pro- 
gramming are acutely felt. 


How DOES 

TELEMON 166 woRK? 
A target-code (or ‘remote’) debugger 
like tdemon 166 consists of a monitor 
core and a debugger shell. It requires a 
fully functional piece of hardware 
using the C166 controller with RAM, 
Flash or EPROM memory. This hard- 
ware should offer PC connectivity 


Comprising powerful CPUs for using acommunication channel. 


By U. Beier, 
Hitex System Development, Germany 
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embedded systems, the 16-bit micro- 
controller family identified as ‘C166’ 
has achieved a strong foothold in the 
microcontroller market. The C166 is 
often found in automotive control 


Running on the target system, the 
monitor core is often considered the 
operating system of the debugger. The 
HiTOP debugger runs as a Windows 
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application on your PC and employs 
an RS232 interface to communicate 
with the COM x port on the PC. 

In the case of the Elektor Electronics 
hardware, the monitor core is stored in 
an EPROM pair (H and L) and up and 
running the moment the hardware is 
switched on. By connecting the hard- 
ware to the PC (via an RS232 cable), 
and then launching the HiTOP Debug- 
ger on the PC you are get a ‘window’ 
with a view on all that’s happening 
inside the controller and its memory. 

Once that has been done you arein 
a position to develop a program for the 
microcontroller, download it into the 
target system and then either launch it 
or execute it in single-step mode. 

To make sure you, the user, remains 
in full control, the program has to be 
stored in the RAM memory on the 
controller board. So, a couple of impor- 
tant pints should be observed when 
working with such a debugger. 


WINDOWS ON WINDOWS 
Obviously, embedded systems based 
on powerful 16-bit controllers with a 
full complement of complex peripherals 
tied to an extensive interrupt structure 
are easily made to enter a state when 
nothing seems to work anymore. Up to 
a certain level, such erroneous states 
may be analysed using a tool like tde 
mon 166. 

Using a couple of practical examples 
described below you will get to know 
the functions of HiTOP. 


Instruction window 

Once HiTOP is up and running, three 
windows are opened for you (Instruc- 
tion, List and Register). 

The Instruction window shows the dis- 
assembled contents of the memory 
range pointed to by the program 
counter. This window allows you to 


The software: 


telemon 166 for 


the Elektor 


80C166 board 


The availability of the HiTOP ‘telemon 166’ debugger from 


ea (Sfrl} SFR - GPT1 T2/T3/T4 









T2 T4 T3 
Control T2CON : 9606 T4CON : AAAA T3CON : 6600 
Mode i ake timer timer 
Input a Timer 1/78 Timer 1/8 


State stopp stopped reset 
Internal up/down control up up up 
External uv/down control disabled disabled disabled 


Output Tr ial SFR" " x] 


Alternat: 
External uj | Value 
Input ] 

| Cancel | 

Symbol... | 
GLUL 

| Press ENTE! — "p | 
eg (Sfr2} SFR - PEC channels -oi xi 













Interrupt 
Control 1 
Request 
State 


ILUL Timer 1/32 





Timer 1/128 
































Increment Type Counter Source Destination 
PECCO: 0563 source byte 63 SRCP@ : DSTP@ : 406 
PECC1: 6466 no increment word BA SRCP1 : 





PECC2: AAAA no increment word 8A SRCP2 : 
9666 no increment word aa SRCP3 : 


: 6686 no increment word BA SRCP4 : 
PE : 8666 no increment word 66 SRCPS : 
PECC6: ABBAA no increment word aa SRCP6 : 


PECC?: 6666 no increment word 6a SRCP? : 





l No register currently selected | 





Figure 2. Watching what hap- 
pens to the Special Function 


Registers. 


view your assembly-code program 
after it has been downloaded. You can 
choose to execute the program step by 
step, set breakpoints or view and mod- 
ify variables. 

If you are using a ‘Keil’ or ‘Tasking’ 
assembler, you can use full symbolic 
debugging under HiTOP. 


Register window 

The current contents of the standard 
registers inside the microcontroller are 
always displayed in this window. On 
each program start, the modified reg- 
isters are highlighted by a colour. In 
this way, you can immediately see the 
effects certain instructions have had on 
a register. 


List window 
The List window shows lines of ‘C’ 


source code when the controller is 
being programmed in a higher pro- 
gramming language. In this window, 
too, the program may be executed step 
by step and variables may be 
inspected. 


Memory window 

HiTOP allows you to open as many 
Memory windows as you like. These 
windows may display different mem- 
ory ranges. The memory contents may 
be shown in different notations (byte, 
word, dword, integer, long, float, dou- 
ble). These memories may also be 
edited using the local functions Fill, 
Move, Test and Compare. 


Watch window 
In the Watch window, a number of 
individual objects (simple or complex 


80C166 board should be populated as follows: 


Segment 0 
Segment 1 


64 kByte RAM 
64 kByte EPROM containing the tele- 


mon 166 monitor, v1.0, KHD 80C166 (low 


Segment 2 
Segmant 3 


Hitex, adapted for the Elektor 80C 166 development sys- 


tem means that you, the user, have an alternative to the 
software described in the April 1999 magazine. Recap- 
ping, this software also consist of a PC program and a 


monitor program stored in pair of EPROMs. Arguably the 


larger number of possibilities offered by the Hitex software 
means that the program is a bit more difficult to control. 
Even if this may seem obvious, the software mentioned in 
the April 1999 magazine can notbe used with the HiTOP PC 
program. If the HiTOP debugger shell is employed on the 
PC, the two EPROMs on the 80C166 board should con- 
tain the monitor core provided by HiTOP telemon 166. The 


and high) 

64 kByte RAM 

optional 16 or 32 kByte EEPROM 
SIO-1 (UART) as the serial port 


A short description of adaptations on the Elektor C166 
board, plus a memory allocation overview may be found 
in the file x:\hitopwin\telemon\monitor\KREADME.TXT. 


The adapted debugger software HiTOP (Windows version) 
and the code for the HiTOP-compatible monitor EPROMs 
may be found on two diskettes, order code 996015A+B, 
available through our Readers Services. The EPROMs are 
also available ready-programmed under order code 
996512-A+B. For price and ordering information, see the 
Readers Services pages towards the end of this issue. 
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variables) may be displayed ij the 
proper format. With complex variables, 
for example, structures or arrays, these 
can be resolved in so-called ‘Examine’ 
windows (see Figure 1). 


User SFR windows 

It is widely known that the members of 
the ‘C166 controller family have exten- 
sive on-chip peripheral circuitry. These 
circuits may be activated by suitable 
programming of the Special Function 
Register, or ‘SFR’. To be able to do so, 
you normally have to study the proces- 
sor manual in great detail, because 
these control registers consists of sub- 
registers whose bit contents deter- 
mines a particular function. 

By means of the SFR window 
offered by HiTOP the user is not only 
able to view the control registers con- 
tents in plain language but also change 
it as required. In this way, you no 
longer have to thumb through the 
processor manual to locate the SFR 
names, functions and meanings (see 
Figure 2). 

HiTOP however also allows you to 
define your own windows, as well as 
assign texts to variables. This is shown 


REGION: BASE “#DEMOMOD#Il", LENGTH 
-|_hex 0x00, 1, RW, 
-|_dec 0x00, il, RW, 
-|_txt 0x00, 1, RW, 
ZOR e 

ae VOD 

Bay DDD apy 

=> =)>=)=)>2=)) 

= 4: " DODDDDDDDDDDDDDDDDDDD DDS" 
ENDREGI ON 

REGION: BASE “#DEMOMOD#m", LENGTH 
-m_hex 0x00, I RW, 

-m dec 0x00, il, RW, 
-mtxt 0x00, il; RW, 

= 10: “Data Frame Error” 

= 11: “Bad CRC" 


12: “Low Voltage !!!" 
13: “High Pressure” 

14: “System Shut Down" 
ENDREGI ON 


WINDOW 1 “User’s Variables” 


"Digital/Analog Value - Hex 
"Digital/Analog Value - Decimal 
"Digital/Analog Value - 














"Error Value - Hex 





"Error Value - Decimal 
"Error Value - graphical 
ENDWI NDOW 


"Digital/Analog Input and Error Report” 


graphical 


Gal (Sfr1} SFR - User's Variables -ol x! 
Digital/fAnalog Input and Error Report 
Digital/fAnalog Value - Hex 4 
Digital/Analog Value - Decimal 4 
Digital/Analog Value - graphical ——— any 
Error Value — Hex D 
Error Value — Decimal : Recent Gs ENP 
Error Value - graphical (High Pressure -2_! 
| Press ENTER to change String | RWdU 
| ial SFR"" Ea 









Data Frame Error 
Bad CRC 


Value 
Iz Pressure | 


‘Low Voltage !!! 
High Pressure 
System Shut Down 


Cancel | 
Symbol... | 
Help | 











Figure 3 Create your 


in the illustration 
‘make your own win- 
dowsin HiTOP’. 
Such windows are easily created with 
the aid of script that describes their 
structure. An example of a script for a 
DIY window is shown below 


Stack window 
The stack window shows the complete 
stack range of the processor, with the 


own windows in HiTOP. 


amount of stack space 
used so far marked in 
colour. 


BREAKPOINTS 

HiTOP offers avery convenient way of 
setting and dearing breakpoints. To do 
so, you simply open an ‘Instruction’ or 
‘List’ window. Left-clicking in the ‘BP’ 
column at the relevant line then sets a 
breakpoint. When the cursor is in the 


0x1 ; Definition of Variables (as Symbol) 
HEX, UPD_RUN ; Hex representation 

DEC, UPD_RUN ; Decimal representation 

ENUM, UPD_RUN ; Text representation 


;quasi-graphic representation 


0x1 ;one more variable 
HEX, UPD_RUN 
DEG UPD_RUN 
ENUM, UPD_RUN 


; Definition of window layout 


:"[-l_hex#]] 
EA E] 


A AEO GE E EEEE EEEE EEE EEE EEE EEE EEIE 


:"[-mhex#]]| 
:"[-m dec##] | 
:"[-m txt ##ttee eee eee eae] | 
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CONSTRUCTION 


Elektor Electronics (Publishing) does not provide parts and compo- 
nents other than Pces, fornt panel foils and software on diskette or Ic 
(not necessarily for all projects). Components are usually available 
form a number of retailers - see the adverts in the magazine. 


Large and small values of components are indicated by means of one 
of the following prefixes : 


E (exa) = 1018 a (atto) = 10-18 

P (peta) = 1015 f (femto) = 10-15 
T (tera) = 1012 p (pico) = 10-12 
G (giga) = 109 n (nano) = 10-9 
M (mega) = 106 u (micro) = 10-6 
k (kilo) = 103 m (milli) = 10-3 

h (hecto) = 102 c(centi) = 10-2 
da (deca) = 101 d (deci) = 10-1 


In some circuit diagrams, to avoid confusion, but contrary to lec and 
BS recommandations, the value of components is given by substitut- 
ing the relevant prefix for the decimal point. For example, 

3k9 = 3.9kQ 4u7 = 4.7 uF 


Unless otherwise indicated, the tolerance of resistors is + 5% and their 
rating is 4-¥% watt. The working voltage of capacitors is > 50 V. 


In populating a pcs, always start with the smallest passive compo- 
nents, that is, wire bridges, resistors and small capacitors; and then Ic 
sockets, relays, electrolytic and other large capacitors, and connectors. 
Vulnerable semiconductors and ics should be done last. 


Soldering. Use a 15-30 W soldering iron with a fine tip and tin with 
a resin core (60/40) Insert the terminals of components in the board, 
bend them slightly, cut them short, and solder: wait 1-2 seconds for 
the tin to flow smoothly and remove the iron. Do not overheat, par- 
ticularly when soldering ics and semiconductors. U nsoldering is best 
done with a suction iron or special unsoldering braid. 


Faultfinding. If the circuit does not work, carefully compare the pop- 
ulated board with the published component layout and parts list. Are 
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column marked ‘PC’, left- 
clicking the mouse causes 
the program to be exe 
cuted up to this line (tem- 
porary breakpoint). 


THE 
MENU 


The Go menu con- 
tains a number of 


debugging. Thisis 
called ‘Run-Con- 


it. After all, you want to see the response 
of the program to the hardware. If the 
program does not respond the way it 
should, you should be n a position to 
execute it step by step and so examine 
G the effects of individual instructions. 
o 

CONCLUSION 

Thetdenon 166 debugging system rep- 
resents a luxurious developing tool 
which is also available as a freely con- 


important functions figurable system (it may be adapted to 
that are necessary just about any C166/167 hardware sys- 
for comfortable tem). In conjunction with the ‘COM- 


BOX’ extension it is even possible to 
employ other communication channds 


trol’. between PC and hardware than just 


If you want to the RS232 link. Examples include a 2- 
debug your wire link via two port pins with inter- 
application pro- rupt capacity, CAN or a synchronous 
gram, you interface. If you are interested in 
obviously exploring these possibilities, go to 
should be http:/Awww.hitex.com for further infor- 


able to start mation. 


(990028-3) 


GUIDELINES 


all the components in the correct position? Has correct polarity been 
observed? H ave the powerlines been reversed? Are all solder joints 
sound? H ave any wire bridges been forgotten? 

If voltage levels have been given on the circuit diagram, do those 
measured on the board match them - note that deviations up to + 10% 
from the specified values are acceptable. 


Possible corrections to published projects are published from time to 
time in this magazine. Also, the readers letters column often contains 
useful comments/additions to the published projects. 


The value of a resistor is indicated by a colour code as follows. 








\ Mi H 

color 1st digit 2nd digit mult. factor tolerance 
black - 0 > = 
brown 1 1 x101 +1% 
red 2 2 x102 +2% 
orange 3 3 x103 - 
yellow 4 4 x104 - 
green 5 5 x105 +0,5% 
blue 6 6 x106 - 
violet 7 7 - - 
grey 8 8 S = 
white 9 9 - - 
gold - - x10-1 +5% 
silver - - x10-2 +10% 
none - - - +20% 

Examples: 


brown-red-brown-gold = 120 Q, 5% 
yellow-violet-orange-gold = 47 kQ, 5% 
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